home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / PROGMISC / FXREF12.LZH / TLDR20.ZIP / TOOLDRIV.DOC < prev    next >
Text File  |  1992-12-21  |  80KB  |  1,791 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  T o o l D r i v e r
  9.  Version 2.0
  10.  ────────────────────
  11.  User's Guide
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  Organizing files and naming conventions /
  19.    Professional Tools /
  20.        for Software Developers and Consultants
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                                  ┌───────┐
  30.                             ┌───────┐    │                (R)
  31.                           ──│       │    │───────────────────
  32.                             │  ┌───────┐ │  Association of
  33.  ConVal Software, Inc.      │  │       │─┘  Shareware
  34.                             └──│   o   │    Professionals
  35.                           ─────│   |   │─────────────────────
  36.                                └───┴───┘    MEMBER
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  T o o l D r i v e r
  54.  Version 2.0
  55.  ────────────────────
  56.  User's Guide
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  Organizing files and naming conventions /
  64.    Professional Tools /
  65.       for Software Developers and Consultants
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.                                  ┌───────┐
  75.                             ┌───────┐    │                (R)
  76.                           ──│       │    │───────────────────
  77.                             │  ┌───────┐ │  Association of
  78.  ConVal Software, Inc.      │  │       │─┘  Shareware
  79.                             └──│   o   │    Professionals
  80.                           ─────│   |   │─────────────────────
  81.                                └───┴───┘    MEMBER
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  Copyright 1990-1992 ConVal Software, Inc.
  102.  All rights reserved.
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116. This program is produced by a member of the Association of Shareware
  117. Professionals (ASP).  ASP wants to make sure that the shareware principle
  118. works for you. If you are unable to resolve a shareware-related problem with
  119. an ASP member by contacting the member directly, ASP may be able to help.
  120. The ASP Ombudsman can help you resolve a dispute or problem with an ASP
  121. member, but does not provide technical support for members' products.
  122.  
  123. Please write to the ASP Ombudsman at:
  124.  
  125.  ASP Ombudsman
  126.  545 Grover Road
  127.  Muskegon, MI  49442-9427
  128.  U.S.A.
  129.  
  130. or send a CompuServe message via CompuServe MAIL to ASP Ombudsman
  131. 70007,3536.
  132.  
  133. The ombudsman may be contacted by FAX by sending to the ASP FAX number:
  134. (616) 788-2765. In communication with the ombudsman please include a
  135. telephone number and/or FAX if available.
  136.  
  137.  
  138. Turbo Vision is a registered trademark of Borland International, Inc.
  139. Portions Copyright Borland International, Inc. Used by permission.
  140.  
  141.  
  142. TABLE OF CONTENTS
  143.  
  144.  
  145.  
  146.  Preface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  viii
  147.  
  148.  SECTION 1: Introduction. . . . . . . . . . . . . . . . . . . . . . . . . 9
  149.  What's in ToolDriver?. . . . . . . . . . . . . . . . . . . . . . . . . . 9
  150.  Hardware and software requirements . . . . . . . . . . . . . . . . . . . 9
  151.  How to contact ConVal Software . . . . . . . . . . . . . . . . . . . . . 9
  152.  The ToolDriver package . . . . . . . . . . . . . . . . . . . . . . . .  10
  153.  
  154.  SECTION 2: Installing ToolDriver . . . . . . . . . . . . . . . . . . .  10
  155.  
  156.  SECTION 3: ToolDriver Basics . . . . . . . . . . . . . . . . . . . . .  11
  157.  Starting ToolDriver. . . . . . . . . . . . . . . . . . . . . . . . . .  11
  158.  Exiting ToolDriver . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  159.  The User Interface . . . . . . . . . . . . . . . . . . . . . . . . . .  11
  160.     The menu bar and menus. . . . . . . . . . . . . . . . . . . . . . .  12
  161.     Working with windows. . . . . . . . . . . . . . . . . . . . . . . .  14
  162.     The status line . . . . . . . . . . . . . . . . . . . . . . . . . .  17
  163.     Dialog boxes. . . . . . . . . . . . . . . . . . . . . . . . . . . .  18
  164.     Action buttons. . . . . . . . . . . . . . . . . . . . . . . . . . .  18
  165.     Radio Buttons and check boxes . . . . . . . . . . . . . . . . . . .  19
  166.     Input boxes and list boxes. . . . . . . . . . . . . . . . . . . . .  19
  167.  
  168.  SECTION 4: Menus and options reference . . . . . . . . . . . . . . . .  20
  169.  ≡ (System) menu. . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  170.     Register. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  171.     Product Information . . . . . . . . . . . . . . . . . . . . . . . .  20
  172.  File menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  20
  173.     View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  21
  174.     Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  175.     Change Dir. . . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  176.     DOS Shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  23
  177.     Quit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  24
  178.  Edit menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  24
  179.     Cut . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  25
  180.     Copy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  25
  181.     Paste . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  25
  182.     Show Clipboard. . . . . . . . . . . . . . . . . . . . . . . . . . .  25
  183.  Search menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  26
  184.     Find. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  26
  185.     Replace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  27
  186.     Search Again. . . . . . . . . . . . . . . . . . . . . . . . . . . .  27
  187.  FileXref . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  28
  188.     Files to cross reference. . . . . . . . . . . . . . . . . . . . . .  28
  189.     Words to cross reference. . . . . . . . . . . . . . . . . . . . . .  29
  190.     Start cross referencing . . . . . . . . . . . . . . . . . . . . . .  29
  191.        Condensed Reports. . . . . . . . . . . . . . . . . . . . . . . .  31
  192.        Extended Reports . . . . . . . . . . . . . . . . . . . . . . . .  32
  193.        Export files . . . . . . . . . . . . . . . . . . . . . . . . . .  33
  194.     View the output log . . . . . . . . . . . . . . . . . . . . . . . .  34
  195.  
  196.  NameChanger menu . . . . . . . . . . . . . . . . . . . . . . . . . . .  34
  197.     Files to process. . . . . . . . . . . . . . . . . . . . . . . . . .  35
  198.     Names to be changed . . . . . . . . . . . . . . . . . . . . . . . .  36
  199.     Start name changing . . . . . . . . . . . . . . . . . . . . . . . .  36
  200.     View the output files . . . . . . . . . . . . . . . . . . . . . . .  37
  201.  Window menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  38
  202.     Size/Move . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  38
  203.     Zoom. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  38
  204.     Tile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  38
  205.     Cascade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  38
  206.     Next. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  38
  207.     Previous. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  38
  208.     Close . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  38
  209.  Help menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  39
  210.     Contents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  39
  211.     Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  39
  212.  
  213.  INDEX. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  40
  214.  
  215.  
  216.  
  217.                                  FIGURES
  218.  
  219.  
  220. Figure 1: A typical window . . . . . . . . . . . . . . . . . . . . . . . 15
  221. Figure 2: View a File dialog box . . . . . . . . . . . . . . . . . . . . 21
  222. Figure 3: Change Directory dialog box. . . . . . . . . . . . . . . . . . 23
  223. Figure 4: The Find Text dialog box . . . . . . . . . . . . . . . . . . . 26
  224. Figure 5: The Replace Text dialog box. . . . . . . . . . . . . . . . . . 27
  225. Figure 6: Files to cross reference . . . . . . . . . . . . . . . . . . . 28
  226. Figure 7: The Cross reference files dialog . . . . . . . . . . . . . . . 30
  227. Figure 8: Condensed File Cross Reference Report. . . . . . . . . . . . . 31
  228. Figure 9: Condensed Word Usage Report. . . . . . . . . . . . . . . . . . 31
  229. Figure 10: List of Unreferenced Files. . . . . . . . . . . . . . . . . . 32
  230. Figure 11: Extended File Cross Reference Report. . . . . . . . . . . . . 32
  231. Figure 12: Extended Word Usage Report. . . . . . . . . . . . . . . . . . 33
  232. Figure 13: Cross reference export data . . . . . . . . . . . . . . . . . 34
  233. Figure 14: Unreferenced files export data. . . . . . . . . . . . . . . . 34
  234. Figure 15: NameChanger Files dialog. . . . . . . . . . . . . . . . . . . 35
  235. Figure 16: The Change names dialog . . . . . . . . . . . . . . . . . . . 36
  236. Figure 17: View the name-changed files dialog box. . . . . . . . . . . . 37
  237.  
  238.  
  239.  
  240.                                   TABLES
  241.  
  242.  
  243. Table 1: General hot keys. . . . . . . . . . . . . . . . . . . . . . . . 13
  244. Table 2: Menu hot keys . . . . . . . . . . . . . . . . . . . . . . . . . 13
  245. Table 3: Editing hot keys. . . . . . . . . . . . . . . . . . . . . . . . 13
  246. Table 4: Window management hot keys. . . . . . . . . . . . . . . . . . . 14
  247. Table 5: Online help hot keys. . . . . . . . . . . . . . . . . . . . . . 14
  248. Table 6: How to use windows. . . . . . . . . . . . . . . . . . . . . . . 17
  249. Table 7: Export file flags . . . . . . . . . . . . . . . . . . . . . . . 33
  250.  
  251.     Preface
  252.      ──────────────────────────────────────
  253.     Welcome to this user guide to ToolDriver. It describes how you can
  254.     better organize your files and names. This information will be
  255.     useful to anyone responsible for developing, managing, or
  256.     maintaining application software.
  257.  
  258.     You will learn:
  259.      ■ The value of understanding the relationships of source files.
  260.  
  261.      ■ How planning your naming conventions can assist in debugging.
  262.  
  263.      ■ How to uncover obsolete components.
  264.  
  265.      ■ An easy way to change old programs to your current naming style.
  266.  
  267.      ■ Organizing tricks that eliminate entire classes of problems.
  268.  
  269.      ■ Characteristics of a well organized application.
  270.  
  271.      ■ Ways to prevent unanticipated naming problems.
  272.  
  273.     Software applications require careful planning and thoughtful
  274.     implementation. The information provided here will help you
  275.     understand the detailed organization of your application and
  276.     communicate that understanding to others, making your job much
  277.     easier.
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.                                                                     Page   9
  287. SECTION 1: Introduction
  288.  ──────────────────────────────────────
  289.  
  290. What's in ToolDriver?
  291.  ■ An integrated environment for running the ConVal programming tools.
  292.  
  293.  ■ FileXref - cross references your files and names. It reads text files and
  294.    documents their use of other files and words you've selected. It works on
  295.    many languages including C, C++, Pascal, COBOL, BAS, MASM, SQL, Fortran,
  296.    and xBase. And it works on all documentation in text file form.
  297.  
  298.  ■ NameChanger - transforms names in the files associated with your
  299.    application.
  300.  
  301.  ■ FileList - reads your disk and creates a list of file names to be cross
  302.    referenced.
  303.  
  304.  ■ Cre8FSL - A tool like FileList. It creates a list of file names to be
  305.    name-changed.
  306.  
  307. Hardware and software requirements
  308. ToolDriver runs on machines with an 80286 or higher processor and running
  309. DOS 3.1 or higher.  A hard disk, and at least one floppy drive are also
  310. required to run ToolDriver.
  311.  
  312. ToolDriver supports (but does not require) any Windows-compatible mouse.
  313.  
  314.  
  315. How to contact ConVal Software
  316. ConVal Software, Inc.
  317. 11607 E. Butter Creek Road
  318. Moorpark, CA 93021-2412
  319.  
  320. Sales and
  321. technical support:        Monday - Friday
  322.  
  323. Voice      (805) 529-6847 9 AM - 5 PM Pacific Time
  324. Fax        (805) 529-4314
  325. CompuServe 72330,1621
  326.                                                                     Page  10
  327. The ToolDriver package
  328. Your ToolDriver package consists of a set of disks, a ToolDriver User's
  329. Guide (this manual), FileXref User's Guide, and a NameChanger User's Guide.
  330. The FileXref and NameChanger user guide documents will only be needed if you
  331. want to run these tools outside of the ToolDriver environment (directly from
  332. DOS).
  333.  
  334. The disks contain all the programs and files you need to cross reference
  335. your disk files and make changes to your naming conventions.
  336.  
  337.  
  338. SECTION 2: Installing ToolDriver
  339.  ──────────────────────────────────────
  340. Users who downloaded ToolDriver from a BBS see README.DOC for installation
  341. instructions.
  342.  
  343. The ToolDriver installation procedure will verify that you have enough space
  344. on your hard drive, create directories as needed and transfer files from
  345. the distribution diskette to your hard disk. It will let you print out the
  346. documentation and read pertinent information about ToolDriver. Its actions
  347. are self-explanatory; the following instructions tell you all you need to
  348. know.
  349.  
  350. To install ToolDriver:
  351.  1.   Insert the installation disk into drive A. Type the following command,
  352.       then press Enter.
  353.  
  354.          A:INSTALL
  355.  
  356.  2.   Follow the prompts.
  357.  
  358.  3.   At the end of installation, you may want to add this line to your
  359.          CONFIG.SYS file: FILES=20
  360.  
  361.  4.   Insure that DOS is in the PATH statement in your AUTOEXEC.BAT file.
  362.  
  363.  
  364. Running ToolDriver
  365.  
  366. Once you've installed ToolDriver, and if you're anxious to get up and
  367. running, change to the TOOLDRIV directory (if you didn't pick another name
  368. yourself), type TD and press Enter.  Otherwise, continue reading this
  369. documentation to see what you can do with ToolDriver.  
  370.                                                                     Page  11
  371. SECTION 3: ToolDriver Basics
  372.  ──────────────────────────────────────
  373. The ToolDriver platform for organizing files and names was developed using
  374. Borland's Turbo Vision for C++. It has everything you need to setup, run,
  375. view and print output from cross referencing as well as name-changing
  376. functions.
  377.  
  378. It provides:
  379.  ■ multiple resizable windows that can be moved
  380.  ■ mouse support and dialog boxes
  381.  ■ cut, paste, and copy commands using a clipboard
  382.  ■ a small, fast editor for preparing and revising input files
  383.  ■ online Help
  384.  ■ quick access to other programs and back again
  385.  
  386. This section explains the following topics:
  387.  ■ starting and exiting ToolDriver
  388.  ■ working with windows
  389.  ■ using dialog boxes to communicate with ToolDriver
  390.  
  391. Starting ToolDriver
  392. To start ToolDriver, go to the ToolDriver directory ( C:\TOOLDRIV by default
  393. ), type TD and press Enter at the DOS prompt.
  394.  
  395. Exiting ToolDriver
  396. There are two ways to leave ToolDriver:
  397.  ■ Choose File│Quit to leave ToolDriver completely; you have to type TD
  398.    again to reenter it. You'll be prompted to save your work before exiting,
  399.    if you haven't already done so.
  400.  
  401.  ■ Choose File│DOS Shell to shell out from ToolDriver to enter commands at
  402.    the DOS command line. When you're ready to return to ToolDriver, type
  403.    EXIT at the command line and press Enter. You will be able to resume work
  404.    just as you left it.
  405.  
  406. The User Interface
  407. ToolDriver has three visible objects: a menu bar at the top of the screen, a
  408. window area in the middle, and a status line at the bottom of the screen.
  409.  
  410. If you are already familiar with the Borland IDE interface, then you may
  411. want to skip the rest of this section and read the sections on cross
  412. referencing (see FileXref, page 28) and changing names (see NameChanger,
  413. page 34).
  414.  
  415.                                                                     Page  12
  416. The menu bar and menus
  417. The menu bar is your primary access to all the commands on the menu. It is
  418. always visible except when you're viewing your program's output or
  419. transferring to another program.
  420.  
  421. Here is how you choose menu commands using the keyboard:
  422.  
  423. 1.   Press F10. This makes the menu bar active. The next thing you type will
  424.      relate to items on the menu bar.
  425.  
  426. 2.   Use the left and right arrow keys to select the menu you want to
  427.      display. Then press Enter.
  428.  
  429.      As a shortcut for this step, you can just press the highlighted letter
  430.      of the menu title. For example, when the menu bar is active press N to
  431.      move to and display the NameChanger menu.
  432.  
  433.      A third way of doing this step is to hold down the Alt key and then
  434.      press a highlighted letter from the menu bar titles (such as Alt+N) to
  435.      display the menu you want.
  436.  
  437. 3.   Use the up and down arrows now to select a command from the menu
  438. displayed.
  439.  
  440. At this point ToolDriver either carries out the command or displays a dialog
  441. box.
  442.  
  443. There are two ways to choose menu commands with a mouse:
  444. 1.   Click the desired menu title to display the menu and click the desired
  445.      command from the menu.
  446.  
  447. 2.   Or, drag straight from the menu title down to the menu command. Release
  448.      the mouse button on the command you want. (If you change your mind,
  449.      just drag off the menu and no command will be chosen.)
  450.  
  451. Some menus and menu commands are unavailable when it would make no sense to
  452. choose them.
  453.  
  454. Following are lists of keyboard shortcuts (or hot keys) for accessing the
  455. menu bar, choosing menu commands, and working with dialog boxes.  
  456.                                                                     Page  13
  457. Table 1: General hot keys
  458.  
  459.  Hot Key    Menu command      Function
  460.   ──────────────────────────────────────
  461.  F1         Help              Displays a context-sensitive help screen
  462.  F2         File│View         Brings up a dialog box for viewing a file
  463.  F4         Window│Close      Closes the active window
  464.  F5         Window│Zoom       Toggles the active window's size
  465.  F10        (none)            Takes you to the menu bar
  466.   ──────────────────────────────────────
  467.  
  468.  
  469. Table 2: Menu hot keys
  470.  
  471.  Hot Key    Menu              Function
  472.   ──────────────────────────────────────
  473.  Alt+Spacebar  ≡              Takes you to the ≡(Product Info) menu
  474.  Alt+E      Edit              Takes you to the Edit menu
  475.  Alt+F      File              Takes you to the File menu
  476.  Alt+H      Help              Takes you to the Help menu
  477.  Alt+N      NameChanger       Takes you to the NameChanger menu
  478.  Alt+S      Search            Takes you to the Search menu
  479.  Alt+W      Window            Takes you to the Window menu
  480.  Alt+X      FileXref          Takes you to the FileXref menu
  481.  ───────────────────────────────────────
  482.  
  483. Table 3: Editing hot keys
  484.  
  485.  Hot Key    Command                 Function
  486.  ─────────────────────────       ──────────────
  487.  Ctrl+Ins   Edit│Copy            Copies selected text to the clipboard
  488.  Shift+Del  Edit│Cut             Places selected text in the clipboard,
  489.                                  deletes selected text
  490.  Shift+Ins  Edit│Paste           Pastes text from the clipboard into the
  491.                                  active window
  492.  Ctrl+Del   Edit│Clear           Removes selected text from a window, but
  493.                                  doesn't put it in the clipboard
  494.  Ctrl+L     Search│Search Again  Repeats last find or replace
  495.  F3         File│Save            Saves the file in the active edit window
  496.   ──────────────────────────────────────
  497.                                                                     Page  14
  498. Table 4: Window management hot keys
  499.  
  500.  Hot Key    Menu command         Function
  501.   ────────────────────────       ──────────────
  502.  Alt+n      (none)               Displays window n, where n is the number
  503.                                  of the window you want to see
  504.  F4         Window│Close         Closes the active window
  505.  F5         Window│Zoom          Toggles the size of the active window
  506.  Ctrl+F5    Window│Size/Move     Changes the size or position of the active
  507.                                  window
  508.  F6         Window│Next          Makes the next window the active one
  509.  Shift+F6   Window│Previous      Makes the prior window the active one
  510.   ──────────────────────────────────────
  511.  
  512. Table 5: Online help hot keys
  513.  
  514.  Hot Key    Function
  515.   ──────────────────────────────────────
  516.  F1         Opens a context-sensitive help screen
  517.  Alt+F1     Displays the previous help screen
  518.   ──────────────────────────────────────
  519.  
  520. Working with windows
  521. Most of what you see and do in ToolDriver happens in a window. A window is a
  522. screen area that you can open, close, move, resize, zoom, tile, and overlap.
  523.  
  524. You can have many windows open in ToolDriver, but only one window can be
  525. active at any time. Any menu command you choose or text you type generally
  526. applies only to the active window.
  527.  
  528. You can easily spot the active window - it's the one with the double-lined
  529. border around it.  The active window always has a close box, a zoom box, and
  530. scroll bars. If your windows are overlapping, the active window is always on
  531. top of all the others.
  532.  
  533. There are several types of windows, but most of them have these things in
  534. common:
  535.  ■ a title bar
  536.  ■ a close box
  537.  ■ scroll bars
  538.  ■ a zoom box
  539.  ■ a window number (1 to 9)
  540.  
  541. An edit window also displays the current line and column numbers in the
  542. lower left corner.  If you've modified your file, an asterisk (*) appears to
  543. the left of the column and line numbers.
  544.                                                                     Page  15
  545. The following figure shows a typical window:
  546.  
  547. Figure 1: A typical window
  548.  
  549.                  ┌────────────────────────┐
  550.                  │ The title bar contains │
  551.                  │ the name of the window │
  552.                  └───────────┬────────────┘
  553.                              │
  554.   ┌───────────────┐          │      ┌───────────────────────┐
  555.   │ Click the     │          │      │ Click on the zoom box │
  556.   │ close box to  │          │      │ to either enlarge or  │
  557.   │ quickly close │          │      │ shrink the window     │
  558.   │ the window    │          │      └─────────────┬─────────┘
  559.   └──────┬────────┘          │                    │
  560.          │                   │                    │
  561.                                                 
  562.  ┌─ ╔══[■}════════════ Window Title ════════ 4 ═[]══╗ ─┐
  563.  │   ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║   │
  564.  │   ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░   │
  565.  │   ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│░░░░░░░▓   │
  566.  │   ║░░░░░░░░░░░░░░░░░░░┌────────────────────┴────┐░░▓   │
  567.  │   ║░░░░░░░░░░░░░░░░░░░│ The first 9 open        │░░▓   │
  568.  │   ║░░░░░░░░░░░░░░░░░░░│ windows have a window   │░░■   │
  569.  │   ║░░░░░░░░░░░░░░░░░░░│ number. Use Alt and n   │░░▓   │
  570.  │   ║░░░░░░░░░░░░░░░░░░░│ to make window n active │░░▓   │
  571.  │   ║░░░░░░░░░░░░░░░░░░░└─────────────────────────┘░░▓   │
  572.  │   ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▓   │
  573.  │   ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▓   │
  574.  │   ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▓   │
  575.  │   ║░░░░░░░░┌───────────────────────────┐░░░░░░░░░░░▓   │
  576.  │   ║░░░░░░░░│ Use a mouse to scroll the ├─────────░▓   │
  577.  │   ║░░░░░░░░│ contents of the window    │░░░░░░░░░░░▓   │
  578.  │   ║░░░░░░░░└─────────┬─────────────────┘░░░░░░░░░░░▓   │
  579.  │   ║░░░░░░░░░░░░░░░░░░│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▓   │
  580.  │   ║░░░░░░░░░░░░░░░░░░│░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▓   │
  581.  │   ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░   │
  582.  │   ╚═▓▓▓▓▓▓▓▓▓■▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓─┘   │
  583.  │                                                      │
  584.  │   │            ┌────────────────────────────┐      │   │
  585.  └───┴────────────│ Drag any corner to make    │──────┴───┘
  586.                   │ windows larger or smaller. │
  587.                   └────────────────────────────┘
  588.  
  589. The close box of a window is the box in the upper left corner. Click this
  590. box to quickly close the window. (Or choose Window│Close.) The help windows
  591. are considered temporary. You can close them by pressing Esc.
  592.                                                                      Page 16
  593.  
  594. The title bar, the topmost horizontal bar of a window, contains the name of
  595. the window and the window number. Double-clicking the title bar zooms the
  596. window. You can also drag the title bar to move the window around.
  597.  
  598. The zoom box of a window appears in the upper right corner. If the icon in
  599. that corner is an up arrow(), you can click the arrow to enlarge the window
  600. to the largest possible size. If the icon is a double-headed arrow(), the
  601. window is already at its maximum size. In that case, clicking it returns the
  602. window to its previous size. To zoom a window from the keyboard, choose
  603. Window│Zoom.
  604.  
  605. The first nine windows you open in ToolDriver have a window number in the
  606. upper right border. You can make a window active (and bring it to the top)
  607. by pressing Alt and the window number. For example if the FileXref output
  608. report window is window number 4 and it's behind other windows, then Alt+4
  609. brings it to the top so it's fully visible.
  610.  
  611. Scroll bars are horizontal or vertical bars that look like this:
  612.  
  613.  ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓■▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  614.  
  615. Scroll bars show you where you are in relation to what you're viewing. You
  616. use these bars with a mouse to scroll the contents of the window. Click the
  617. arrow at either end to scroll one line at a time. (Keep the mouse button
  618. pressed to scroll continuously.) You can click the shaded area to either
  619. side of the scroll box to scroll a page at a time.
  620.  
  621. Finally, you can drag the scroll box to any spot on the bar to quickly move
  622. to a spot in the window relative to the position of the scroll box.
  623.  
  624. You can drag the bottom right corner to make a window larger or smaller. To
  625. resize from the keyboard, choose Size/Move from the Window menu. Use the
  626. arrow keys alone to move or hold down the shift key while using the arrow
  627. keys to resize the window.  Press enter when finished to get out of the
  628. sizing/moving mode.
  629.  
  630. Table 6 is a quick reference for using windows in ToolDriver. Note that you
  631. don't need a mouse to perform these actions - a keyboard works fine too.
  632.                                                                     Page  17
  633.  
  634. Table 6: How to use windows
  635.  
  636.  To do this             Use one of these techniques
  637.  ───────────────────────────────────────────────────────────────────────────
  638.  Open a file viewer     Choose File│View to open a file and scroll it in a
  639.                         window.
  640.  
  641.  Open other windows     Choose the desired window from the Window menu.
  642.  
  643.  Close a window         Choose Close from the Window menu or click the close
  644.                         box of the window or Press F4.
  645.  
  646.  Activate a window      Click anywhere in the window, or
  647.  
  648.                         Press Alt plus the window number (1 to 9), or
  649.  
  650.                         Choose Window│Next (F6 is the hot key) to step
  651.                         through the windows in the order you created them,
  652.                         or
  653.                         Choose Window│Previous (Shift+F6 is the hot key)
  654.                         to step through the windows in the reverse of the
  655.                         order you created them.
  656.  
  657.  Move an active window  Drag its title bar. Or choose Window│Size/Move
  658.                         and use the arrow keys to place the window where you
  659.                         want it, then press Enter.
  660.  
  661.  Resize the active      Drag the bottom right corner. Or choose
  662.  window                 Window│Size/Move and press Shift while you use the
  663.                         arrow keys to resize the window, then press Enter.
  664.  
  665.  Zoom the active        Click the zoom box in the upper right corner of the
  666.  window                 window, or
  667.  
  668.                         Double-click the window's title bar, or
  669.  
  670.                         Choose Window│Zoom (F5 is the hot key)
  671.  ───────────────────────────────────────────────────────────────────────────
  672.  
  673. The status line
  674. The status line appears at the bottom of the screen to
  675.  ■ remind you of basic keystrokes and shortcuts (or hot keys) applicable in
  676.    the active window.
  677.  ■ let you use the mouse to click on a command to perform the action instead
  678.    of choosing the action from the menu or pressing the shortcut keystroke.
  679.  
  680.                                                                     Page  18
  681.  
  682. Here is what the status line looks like:
  683.  
  684.  ┌───────────┬───────────────────────────────────────────┬──┐
  685.  │ToolDriver │ F1 Help F2 View F4 Close F5 Zoom F10 Menu │Id│
  686.  └───────────┴───────────────────────────────────────────┴──┘
  687.  
  688. Where Id is the serial number of your registered software.
  689.  
  690. Dialog boxes
  691. A menu command with an ellipsis (...) after it leads to a dialog box. Dialog
  692. boxes offer a convenient way to view and set multiple options. When you're
  693. making settings in dialog boxes, you work with five basic types of onscreen
  694. controls: action buttons, radio buttons, check boxes, input boxes, and list
  695. boxes.
  696.  
  697. Action buttons
  698.  │  OK     │
  699.  
  700.   │  Cancel │
  701.  
  702. Above are two action buttons, OK and Cancel. If you choose OK, the choices
  703. in the dialog box are accepted; if you choose Cancel, nothing changes, no
  704. action takes place, and the dialog box is put away. Choose Help to open a
  705. Help window about this dialog box. Esc is always a keyboard shortcut for
  706. Cancel (even if no Cancel button appears).
  707.  
  708. If you're using a mouse, click the dialog-box button you want. When you're
  709. using the keyboard, press Alt and the highlighted letter of a command to
  710. activate it. For example Alt+C selects the Cancel button because the C in
  711. Cancel is highlighted. Press Tab or Shift+Tab to move forward or back from
  712. one item to another in a dialog box. Each element is highlighted when it
  713. becomes active.
  714.  
  715. In this dialog box, OK is the default button, which means you need only
  716. press Enter to choose the button. (On monochrome systems, arrows indicate
  717. the default; on color monitors default buttons are highlighted.) Be aware
  718. that tabbing to a button makes that button the default.
  719.                                                                     Page  19
  720.  
  721. Radio Buttons and check boxes
  722.  ┌───────────────────────────────────┐
  723.  │ Radio Buttons        Check Boxes  │
  724.  │ ( ) Option 1         ( ) Option A │
  725.  │ ( ) Option 2         (X) Option B │
  726.  │ (■) Option 3         ( ) Option C │
  727.  │                      (X) Option D │
  728.  └───────────────────────────────────┘
  729.  
  730. Radio buttons are like car-radio buttons. They come in groups, and only one
  731. radio button in the group can be on at any one time. To choose a radio
  732. button, click it or its text. From the keyboard, select Alt and the
  733. highlighted letter, or press Tab until the group is highlighted, and then
  734. use the arrow keys to choose a particular radio button. Press Tab or
  735. Shift+Tab again to leave the group with the new radio button chosen. Check
  736. boxes differ from radio buttons in that you can have any number of check
  737. boxes checked at any time.  When you select a check box, an X appears in it
  738. to show you it's on. An empty box indicates it's off. To change the status
  739. of a check box, click it or its text, press Tab until the check box is
  740. highlighted and then press Spacebar, or select Alt plus the highlighted
  741. letter.
  742.  
  743. If several check boxes apply to a topic, they appear as a group. In that
  744. case, tabbing moves to the group. Once the group is selected, use the arrow
  745. keys to select the item you want, and then press Spacebar to check or
  746. uncheck it. On monochrome monitors, the active check box or group of check
  747. boxes will have a chevron symbol (») to the left and right. When you press
  748. Tab, the chevrons move to the next group of check boxes or radio buttons.
  749.  
  750. Input boxes and list boxes
  751. Input boxes let you type in text. Most basic text-editing keys work in the
  752. text box (for example, arrow keys, Home, End, and Ins). If you continue to
  753. type once you reach the end of the box, the contents automatically scroll.
  754. If there's more text than shows in the box, arrowheads appear at the end (
  755. and ). You can click the arrowheads to scroll or drag the text. If you need
  756. to enter control characters (such as ^L or ^M) in the input box, then prefix
  757. the character with a ^P. So, for example, to enter ^M into the input box,
  758. hold down the Ctrl key and press PM. (This capability is useful for search
  759. strings.)
  760.  
  761. If an input box has a down arrow () icon to its right, there is an
  762. associated history list. Click the icon to display the list. You'll find
  763. text you typed the last few times you used the input box. Press Enter to
  764. choose an item from this list. The Find box, for example, has such a history
  765. list, which keeps track of the text you searched for previously. Try
  766. choosing a previous search string. You can also edit an entry in the history
  767. list. Press Esc to exit from the history list without making a selection
  768. or Enter to continue.  
  769.                                                                     Page  20
  770.  
  771. A final component of many dialog boxes is a list box, which lets you scroll
  772. through and select from variable-length lists (often file names) without
  773. leaving a dialog box.
  774.  
  775. You make a list box active by clicking it or by choosing the highlighted
  776. letter of the list title (or press Tab until it's highlighted). Once a list
  777. box is displayed, you can use the scroll box to move through the list or
  778. press the up and down arrows from the keyboard.
  779.  
  780.  
  781. SECTION 4: Menus and options reference
  782.  ──────────────────────────────────────
  783.  
  784. This section provides a reference to each ToolDriver menu option. It's
  785. arranged in the order that the menus appear on the screen. For information
  786. on starting and exiting ToolDriver, and general information on how the user
  787. interface works, see Section 1.
  788.  
  789. Next to some of the menu option descriptions in this reference you'll see
  790. keyboard shortcuts, or hot keys.
  791.  
  792. ≡ (System) menu  Alt+Spacebar
  793. The ≡ menu appears on the far left of the menu bar. Alt+Spacebar is the
  794. fastest way to get there. When you pull down the menu (by using the down
  795. arrow) you see two commands, Register and Product Information.
  796.  
  797. Register
  798. Choose ≡│Register to print information about the advantages of registering
  799. and to print a ToolDriver Registration form. A file print dialog will be
  800. presented, with the file REGISTER.DOC selected. Just press enter to print
  801. the file.
  802.  
  803. Product Information
  804. The ≡│Product Information menu command displays the version of ToolDriver
  805. you are running. The same information displays when you initially bring up
  806. ToolDriver. Put this information away by pressing enter.
  807.  
  808. File menu  Alt+F
  809. The file menu lets you open and view files in a file viewer window. It also
  810. lets you print files, change the working directory, shell to DOS and exit
  811. the ToolDriver environment.  
  812.                                                                     Page  21
  813.  
  814. View F2
  815. The File│View command displays a file-selection dialog box for you to select
  816. a text file to open in a file viewer window. Here is what the box looks
  817. like:
  818.  
  819. Figure 2: View a File dialog box
  820.  
  821.  ╔══[■}═════════════════ View a File ═══════════════════╗
  822.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  823.  ║░░ Name░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  824.  ║░░░ *.*                              ░░░░░ Open  ░░║
  825.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  826.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  827.  ║░░ Files                               ░░░░░░░░░░░░░░░║
  828.  ║░░░ CRE8FSL.EXE       │  FILEXREF.WSL  ░░░░  Cancel ░░║
  829.  ║░░░ FILELIST.EXE      │  FILEXREF.XRF  ░░░░░░░░░░░░░░░║
  830.  ║░░░ FILEXREF.BAK      │  HISTORY.DOC   ░░░░░░░░░░░░░░░║
  831.  ║░░░ FILEXREF.EXE      │  NAMEC.EXE     ░░░░░░░░░░░░░░░║
  832.  ║░░░ FILEXREF.FEI      │  NAMEC.FSL     ░░░░░░░░░░░░░░░║
  833.  ║░░░ FILEXREF.FSL      │  NAMEC.MSG     ░░░░░░░░░░░░░░░║
  834.  ║░░░ FILEXREF.MSG      │  NAMEC.SRL     ░░░░░░░░░░░░░░░║
  835.  ║░░░»FILEXREF.RPT«     │  \WORK         ░░░░░░░░░░░░░░░║
  836.  ║░░░ ■▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓     ░░░░░░░░░░░░░░░║
  837.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  838.  ║░░░C:\TOOLDRIV\*.*                                    ║
  839.  ║░░░FILEXREF.RPT 133153          Sep 01,1992   09:15a  ║
  840.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  841.  ╚══════════════════════════════════════════════════════╝
  842.  
  843. The dialog box contains an input box, a file list, buttons labeled Open and
  844. Cancel, and an information panel that describes the selected file. Now you
  845. can do any of these actions:
  846.  ■ Type in a full file name and choose Open.  Open loads the file into a
  847.    file viewer window.
  848.  
  849.  ■ Type in a file name with wildcards, which filters the file list to match
  850.    your specifications.
  851.  
  852.  ■ Press  to choose a file specification from a history list of file
  853.    specifications you've entered earlier.
  854.  
  855.  ■ View the contents of different directories by selecting a directory name
  856.    in the file list.
  857.  
  858. The input box lets you enter a file name explicitly or enter a file name
  859. with standard DOS wildcards (* and ?) to filter the names appearing in the
  860. history list box. If you enter the entire name and press enter, ToolDriver
  861. opens it for viewing.
  862.  
  863. If you press  when the cursor is blinking in the input box, a history list
  864.                                                                     Page  22
  865.  
  866. drops down below the box. This list displays the last 15 file names or
  867. file name masks you've entered. Choose a name from the list by
  868. double-clicking it or selecting it with the arrow keys and pressing Enter.
  869.  
  870. Once you've typed in or selected the file you want, choose the Open button
  871. (choose Cancel if you change your mind). You can also just press Enter once
  872. the file is selected, or you can double-click the file name in the file
  873. list.
  874.  
  875. The file viewer will view text files up to about 40K in length.
  876.  
  877. Using the file list box
  878. The File list box displays all file names in the current directory that
  879. match the specifications in the input box, displays the parent directory,
  880. and displays all subdirectories. Click the list box or press Tab until the
  881. list box name is highlighted. You can now press  or  to select a filename
  882. and then press Enter to open it. You can also double-click any file name in
  883. the box to open it. You might have to scroll the box to see all the names.
  884. If you have more than one panel of names, you can also use the left and
  885. right arrows.
  886.  
  887. The file information panel at the bottom of the View a File dialog box
  888. displays path name, file name, date, time and size of the file you've
  889. selected in the list box. As you scroll through the list box, the panel is
  890. updated for each file.
  891.  
  892. Print
  893. The File│Print command displays a file-selection dialog box for you to
  894. select a text file to be printed. It looks and functions like the File│View
  895. command except that the output will be routed to your printer instead of a
  896. file viewer.
  897.  
  898. Change Dir
  899. The File│Change Dir command lets you specify a drive and a directory to make
  900. current.  The current directory is the one ToolDriver uses for viewing and
  901. printing files.
  902.  
  903. Here is what the Change Directory dialog box looks like:
  904.                                                                     Page  23
  905.  
  906. Figure 3: Change Directory dialog box
  907.  
  908.  ╔══[■}═══════════════ Change Directory ════════════════╗
  909.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  910.  ║░░ Directory Name ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  911.  ║░░░ C:\TOOLDRIV                      ░░░░░░░░░░░░░░░░║
  912.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  913.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  914.  ║░░ Directory Tree                      ░░░░░░░░░░░░░░░║
  915.  ║░░░ Drives                            ░░░░  OK     ░░║
  916.  ║░░░        C:\                   ▓     ░░░░░░░░░░░░░░░║
  917.  ║░░░        └─TOOLDRIV            ▓     ░░░░  Chdir  ░░║
  918.  ║░░░          └─WORK              ▓     ░░░░░░░░░░░░░░░║
  919.  ║░░░                              ■     ░░░░  Revert ░░║
  920.  ║░░░                              ▓     ░░░░░░░░░░░░░░░║
  921.  ║░░░                              ▓     ░░░░░░░░░░░░░░░║
  922.  ║░░░                                   ░░░░░░░░░░░░░░░║
  923.  ║░░░                                    ░░░░░░░░░░░░░░░║
  924.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  925.  ╚══════════════════════════════════════════════════════╝
  926.  
  927.  
  928. There are two ways to change directories:
  929.  ■ Type in the path of the new directory in the input box and press Enter
  930.  
  931.  ■ Choose the directory you want in the directory tree (if you're using the
  932.    keyboard, press Enter to make it the current directory), then choose OK
  933.    or press Esc.
  934.  
  935. If you choose the OK button, your changes are made and the dialog box is
  936. closed. If you choose the Chdir button, the Directory Tree list box changes
  937. to the selected directory and displays the subdirectories of the currently
  938. highlighted directory (pressing Enter or double-clicking on that entry
  939. gives you the same result). If you change your mind about the directory
  940. you've picked and you want to go back to the previous one (and you've yet to
  941. exit the dialog box), choose the Revert button.
  942.  
  943. Running commands under the FileXref and NameChanger menus automatically
  944. changes the directory to ToolDriver's installation directory where its
  945. program and help files reside.
  946.  
  947. DOS Shell
  948. The File│DOS Shell command lets you temporarily exit ToolDriver to enter a
  949. DOS command or program. To return to ToolDriver, type EXIT and press Enter.
  950.  
  951. Don't install any TSR programs (like SideKick) or print a file with the DOS
  952. print command while you've shelled to DOS, because memory may be
  953. misallocated.
  954.                                                                     Page  24
  955.  
  956. Quit    Alt+Q
  957. The File│Quit command exits ToolDriver and removes it from memory. If you
  958. have made any changes you haven't saved, ToolDriver asks if you want to save
  959. them before exiting.
  960.  
  961. Edit menu     Alt+E
  962. The Edit menu lets you cut, copy, and paste text in edit windows. You can
  963. also open a Clipboard window to view or edit its contents.
  964.  
  965. ToolDriver does not offer a general purpose editor.  An edit window is only
  966. created to support the modification of input files used by the FileXref and
  967. NameChanger utilities.  Edit (and Search) menu commands are disabled
  968. otherwise.
  969.  
  970. A file edit window is presented in four cases:
  971.  ■ after processing the FileXref│Files dialog (This allows you to modify
  972.    the list of files to be cross referenced.)
  973.  
  974.  ■ after choosing the FileXref│Words command (This allows you to modify a
  975.    list of words to be cross referenced.) (You do not need to list the names
  976.    of any files here - they are automatically cross referenced.)
  977.  
  978.  ■ after processing the NameChanger│Files dialog (This allows you to
  979.    modify the list of files to be name-changed.)
  980.  
  981.  ■ after choosing the NameChanger│Names command (This allows you to specify
  982.    the names to be changed and what they are to be changed to.) (Names may
  983.    be file names; variable names; i.e. any complete symbol)
  984.  
  985. Before you can use most of the commands on the edit menu, you need to know
  986. about selecting text (because most editor actions apply to selected text).
  987. Selecting text means highlighting it. You can select text either with
  988. keyboard commands or with a mouse; the principle is the same even though the
  989. actions are different.
  990.  
  991. From the keyboard
  992.  ■ Press Shift while pressing any key that moves the cursor.
  993.  
  994. Using a mouse
  995.  ■ To select text with a mouse, drag the mouse pointer over the desired text
  996.    If you need to continue the selection past a window's edge, just drag off
  997.    the side and the window automatically scrolls.
  998.  
  999.  ■ To select a single word, double-click it.
  1000.                                                                     Page  25
  1001.  
  1002.  ■ To extend or reduce the selection, Shift-click anywhere in the document
  1003.    (that is, hold Shift and click). Once you've selected text, the Cut and
  1004.    Copy commands in the Edit menu become available.
  1005.  
  1006. The Clipboard is the magic behind cutting and pasting. It's a special window
  1007. that holds text you cut or copied, so you can paste it elsewhere. The
  1008. Clipboard works in close concert with the commands in the Edit menu.
  1009.  
  1010. Here's an explanation of each command in the Edit menu.
  1011.  
  1012. Cut    Shift+Del
  1013. The Edit│Cut command removes the selected text from your document and places
  1014. the text in the Clipboard. You can then paste that text into any other
  1015. document (or somewhere else in the same document) by choosing Paste. The
  1016. text remains selected in the Clipboard so that you can paste the same text
  1017. many times.
  1018.  
  1019. Copy Ctrl+Ins
  1020. The Edit│Copy command leaves the selected text intact but places an exact
  1021. copy of it in the Clipboard. You can then paste that text into any other
  1022. document by choosing Paste.
  1023.  
  1024. Paste   Shift+Ins
  1025. The Edit│Paste command inserts from the Clipboard into the current edit
  1026. window at the cursor position. The text that is pasted is the currently
  1027. marked block in the Clipboard window.
  1028.  
  1029. Show Clipboard
  1030. The Edit│Show Clipboard command opens the Clipboard window, which stores the
  1031. text you cut and copy from other windows. The text that's currently selected
  1032. (highlighted) is the text ToolDriver uses when you choose Paste.
  1033.  
  1034. You can think of the Clipboard window as a history list of your cuts and
  1035. copies. You can edit the Clipboard so that the text you paste is precisely
  1036. the text you want. ToolDriver uses whatever text is selected in the
  1037. Clipboard when you choose Paste.
  1038.  
  1039. The Clipboard window is just like other edit windows; you can move it,
  1040. resize it, and scroll and edit its contents. The only difference you'll find
  1041. in the Clipboard window is when you choose to cut or copy text. When you
  1042. select text in the Clipboard window and choose Cut or Copy, the selected
  1043. text immediately appears at the bottom of the window. (Remember, any text
  1044. you cut or copy is appended to the end of the Clipboard and highlighted - so
  1045. you can paste it later.
  1046.                                                                     Page  26
  1047.  
  1048. Search menu   Alt+S
  1049. The Search menu lets you search and replace text in edit windows.
  1050.  
  1051. Find Ctrl+Q+F
  1052. The Search│Find command displays the Find Text dialog box, which lets you
  1053. type in the text you want to search for and set options that affect the
  1054. search.
  1055.  
  1056. Figure 4: The Find Text dialog box
  1057.  ╔══[■}════════════  Find Text  ════════════════╗
  1058.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1059.  ║░» Text to Find ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1060.  ║░░░aardvark                               ░░░║
  1061.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1062.  ║░░ Options                  ░░░░░░░░░░░░░░░░░░║
  1063.  ║░░░ (X) Case Sensitive      ░░░░░░░░░░░░░░░░░░║
  1064.  ║░░░ ( ) Whole words only    ░░░░░░░░░░░░░░░░░░║
  1065.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1066.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1067.  ║░░░░░░░░░░░░░░░░░░░»  OK  «░░  Cancel  ░░░░░░░║
  1068.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1069.  ╚══════════════════════════════════════════════╝
  1070.  
  1071. The Find Text dialog box contains several buttons and check boxes:
  1072.  
  1073.  ┌────────────────────┐    Check the Case Sensitive box if
  1074.  │ (X) Case sensitive │    you do want ToolDriver to
  1075.  └────────────────────┘    differentiate uppercase from
  1076.                            lowercase.
  1077.  
  1078.  ┌──────────────────────┐  Check the Whole words Only box if
  1079.  │ ( ) Whole words only │  you want ToolDriver to search for
  1080.  └──────────────────────┘  whole words only. (that is, the
  1081.                            string must have punctuation or
  1082.                            space characters on both sides)
  1083.                                                                     Page  27
  1084.  
  1085. Replace Ctrl+Q+A
  1086. Following is the dialog for replacing text.
  1087.  
  1088. Figure 5: The Replace Text dialog box
  1089.  
  1090.  ╔══[■}═════════  Replace Text  ════════════════╗
  1091.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1092.  ║░» Text to Find ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1093.  ║░░░aardvark                               ░░░║
  1094.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1095.  ║░  New text     ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1096.  ║░░░platypus                               ░░░║
  1097.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1098.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1099.  ║░░ Options                  ░░░░░░░░░░░░░░░░░░║
  1100.  ║░░░ (X) Case Sensitive      ░░░░░░░░░░░░░░░░░░║
  1101.  ║░░░ ( ) Whole words only    ░░░░░░░░░░░░░░░░░░║
  1102.  ║░░░ ( ) Prompt on replace   ░░░░░░░░░░░░░░░░░░║
  1103.  ║░░░ ( ) Replace all         ░░░░░░░░░░░░░░░░░░║
  1104.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1105.  ║░░░░░░░░░░░░░░░░░░░»  OK  «░░  Cancel  ░░░░░░░║
  1106.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1107.  ╚══════════════════════════════════════════════╝
  1108.  
  1109. The Replace Text dialog box contains several radio buttons and check boxes -
  1110. many of which are identical to the Find Text dialog box, just discussed.  An
  1111. additional checkbox, Prompt on Replace, controls whether you want to be
  1112. prompted for each change.
  1113.  
  1114. Enter the search string and the replacement string in the input boxes and
  1115. choose OK to begin the search or Cancel to not do it. If you want to enter a
  1116. string you used previously, press  to show a history list to choose from.
  1117.  
  1118. If ToolDriver finds the specified text and Prompt on Replace is on, it asks
  1119. you if you want to make the replacement. If you choose OK, it will find and
  1120. replace the first instance of the search item.
  1121.  
  1122. Search Again  Ctrl+L
  1123. The Search│Search Again command repeats the last Find or Replace command.
  1124. All settings you made in the last dialog box used (Find or Replace) remain
  1125. in effect when you choose Search Again.
  1126.                                                                     Page  28
  1127.  
  1128. FileXref   Alt+X
  1129. The FileXref menu item is the place to go when you want to see how your text
  1130. files relate to one another. It is also where you can find the global usage
  1131. of words (data names, function names, language verbs, etc.) throughout your
  1132. source and documentation files. It may be used with any text file.
  1133.  
  1134. The menu item is named FileXref since it uses the ConVal FILEXREF.EXE
  1135. program to do the cross referencing. This program may also be used
  1136. independently of the ToolDriver environment (see the separate FileXref
  1137. User's Guide in text file FILXRF.DOC).
  1138.  
  1139. There are four supporting options on this menu:
  1140.  ■ Files to cross reference
  1141.  ■ Words to cross reference
  1142.  ■ Start cross referencing
  1143.  ■ View the output log
  1144.  
  1145. Files to cross reference
  1146. Here you identify the files you want to cross reference. You do this by
  1147. creating a list of those file names. The dialog box you use looks like this:
  1148.  
  1149. Figure 6: Files to cross reference
  1150.  
  1151.  ╔══[■}══  Files to be cross referenced ══════════╗
  1152.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1153.  ║░[X]  Generate a file list for me ░░░░░░░░░░░░░░║
  1154.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1155.  ║░     using the directory tree starting with: ░░║
  1156.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1157.  ║░»C:\PROJECT1                             ░░░░░║
  1158.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1159.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1160.  ║░░░░░░░░░░░░░░░░░░░»  OK  «░░  Cancel  ░░░░░░░░░║
  1161.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1162.  ╚════════════════════════════════════════════════╝
  1163.  
  1164.  
  1165. If you check the check box and enter a directory (as above) or drive (like
  1166. C:), then a list will be prepared for you. It will be written to file
  1167. FILEXREF.FSL, the File Specification List. The list will include files in
  1168. the directory entered and in its subdirectories and their subdirectories
  1169. (the directory tree).
  1170.  
  1171. In any case you will be presented with an edit window for this file. The
  1172. contents of the file edit window will be what was just generated if you
  1173. checked the check box, or as most recently edited by you, or it will be as
  1174. delivered on the installation disk.  
  1175.                                                                     Page  29
  1176.  
  1177. Following are representative entries in the file specification list:
  1178. ────────────────────────────────────
  1179. C:\PROJECT1\SOURCE\SAMPLE01.C
  1180. C:\PROJECT1\SOURCE\SAMPLE02.C
  1181. C:\PROJECT1\INCLUDE\MYSAMP.H
  1182. D:\PROJECT1\DOCS\OVERVIEW.DOC
  1183. ────────────────────────────────────
  1184. Start each line in column one and press Enter for each line.
  1185.  
  1186. Press F3 to save your changes or F4 to close the window (this will cause a
  1187. prompt to save).
  1188.  
  1189. NOTE: The editor will handle files to about 64K. This will handle hundreds
  1190. of file names. If your application is larger than this we assume you have an
  1191. editor! Drop out of ToolDriver, edit the list with that editor, and return
  1192. to ToolDriver to do the cross referencing.
  1193.  
  1194. Words to cross reference
  1195. ToolDriver, as installed, provides a starter file of words to cross
  1196. reference. This file is named FILEXREF.WSL (Word Specification List). When
  1197. you first select this option you will see the starter list. It contains
  1198. entries like
  1199. ─────────────────────────
  1200.   I  re*
  1201.   X  return
  1202.   X  break
  1203. ─────────────────────────
  1204. The I/X means to Include or eXclude the word or word prefix.  The entry "I
  1205. re*" asks that words starting with the characters re be included in the word
  1206. usage report. The entry "X return" says to exclude the word "return". (The
  1207. starter list excludes the C keywords. The last entry shown is not required
  1208. (break does not start with "re"). However, it is not considered an error.
  1209. This allows you to keep a list of words to be excluded (like language
  1210. keywords) regardless of the words you are currently including.
  1211.  
  1212. Start cross referencing
  1213. Once you've set up the list of files to be examined and (optionally) the
  1214. words to search for, select this menu item to initiate cross referencing.
  1215.                                                                     Page  30
  1216.  
  1217. This is what the associated dialog looks like:
  1218.  
  1219. Figure 7: The Cross reference files dialog
  1220.  
  1221.  ╔══[■}═════ Cross reference files (and words) ═══════════╗
  1222.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1223.  ║ Type of output         ░ Optional output            ░░░║
  1224.  ║░ (■) Condensed reports ░░ [ ] Cross reference words ░░░║
  1225.  ║░ ( ) Extended reports  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1226.  ║░ ( ) Export file       ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1227.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1228.  ║░░░░░░░░░░░░░░░░░░ »  OK  « ░░ Cancel ░░░░░░░░░░░░░░░░░░║
  1229.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1230.  ╚════════════════════════════════════════════════════════╝
  1231.  
  1232. Three types of output are available. The condensed report format displays
  1233. file names only, without the path or file extension. It packs the most
  1234. information in the smallest number of pages. The extended report format
  1235. displays the full file specification (drive, path, file name and extension).
  1236. Export file format provides a means for you to take the cross reference
  1237. information and use it with other software (e.g. a database program).
  1238.  
  1239. If you click on the optional output of Cross reference words, then the words
  1240. you picked for inclusion and exclusion will be used and a Word Usage Report
  1241. will be produced.  Otherwise the list of words will be ignored.
  1242.  
  1243. Use File│Print to print file FILEXREF.RPT, the report file. Note: The
  1244. reports require 132 print positions.
  1245.  
  1246. When you select condensed reports, the following reports
  1247.  
  1248.  ■ Condensed File Cross Reference Report,
  1249.  ■ Condensed Word Usage Report, and
  1250.  ■ List of Unreferenced Files
  1251.  
  1252. will be written to file FILEXREF.RPT.
  1253.  
  1254. Choosing extended reports will cause these reports
  1255.  ■ Extended File Cross Reference Report,
  1256.  ■ Extended Word Usage Report, and
  1257.  ■ List of Unreferenced Files
  1258.  
  1259. to be written to file FILEXREF.RPT.
  1260.  
  1261. Picking export files will create two text data files:
  1262.  ■ cross reference data on file FILEXREF.XRF, and
  1263.  ■ unused file data on file FILEXREF.FEI   
  1264.                                                                     Page  31
  1265.  
  1266. Condensed Reports
  1267. The condensed style of reports identify files by their filename alone,
  1268. without the drive, path, or file extension. Figure 8 shows a condensed file
  1269. cross reference report (showing less columns to the left and right for
  1270. reasons of space in this manual).  The center column lists every file
  1271. examined, sorted by file name. To the left are the files that reference it
  1272. and to the right are those that it references.
  1273.  
  1274.  
  1275. Figure 8: Condensed File Cross Reference Report
  1276. ────────────────────────────────────────────────────────────────────────────
  1277.  09/19/92  FileXref     CONDENSED FILE CROSS REFERENCE REPORT      Page   1
  1278.  
  1279.  
  1280.  LIST OF REFERENCING FILES      FILENAME    LIST OF REFERENCED FILES
  1281.  ----------------------------   ========    -------------------------------
  1282.                               - FILEXRF  -
  1283.            PACKLIST  TOOLDRIV - HISTORY  -
  1284.                               - NAMECHNG -  README
  1285.                               - PACKLIST -  HISTORY   README    REGISTER
  1286.                                             TOOLDRIV
  1287.  NAMECHNG  PACKLIST  TOOLDRIV - README   -
  1288.            PACKLIST  TOOLDRIV - REGISTER -
  1289.                      PACKLIST - TOOLDRIV -  HISTORY   README    REGISTER
  1290.  
  1291.   *** END OF REPORT
  1292. ────────────────────────────────────────────────────────────────────────────
  1293.  
  1294. In Figure 9 you see the optional condensed word usage report. This shows
  1295. each word (and word prefix) requested, and the files that reference them.
  1296.  
  1297. Figure 9: Condensed Word Usage Report
  1298.  
  1299. ────────────────────────────────────────────────────────────────────────────
  1300.  09/19/92 05:33:38 FileXref  CONDENSED WORD USAGE REPORT             Page 1
  1301.  
  1302.  WORD                            IS REFERENCED BY FILENAME(S):
  1303.  ------------------------------  -------------------------------------------
  1304.  However                         FILEXRF
  1305.  Hungarian                       NAMECHNG
  1306.  I                               FILEXRF  HISTORY  NAMECHNG README  REGISTER
  1307.                                  TOOLDRIV
  1308.  IBM                             NAMECHNG TOOLDRIV
  1309.  IBM-compatible                  TOOLDRIV
  1310.  IBMPRO                          HISTORY
  1311.  ID                              NAMECHNG
  1312.  IDE                             TOOLDRIV
  1313.  IMS                             NAMECHNG
  1314.  INCLUDE                         FILEXRF  NAMECHNG TOOLDRIV
  1315.  
  1316.   *** END OF REPORT
  1317. ────────────────────────────────────────────────────────────────────────────
  1318.      
  1319.                                                                     Page  32
  1320.  
  1321. In figure 10 we see a list of files that were referenced by no other files.
  1322. So this list will contain top level components (and old obsolete components)
  1323. of the application.
  1324.  
  1325. Figure 10: List of Unreferenced Files
  1326.  
  1327. ────────────────────────────────────────────────────────────────────────────
  1328.  09/19/92  05:33:39  FileXref         LIST OF UNREFERENCED FILES     Page  1
  1329.  
  1330.  
  1331.               FILENAME  TYPE    PATH
  1332.               --------  ---    -------------------------
  1333.               FILEXRF   DOC     C:\TOOLDRIV\
  1334.               NAMECHNG  DOC     C:\TOOLDRIV\
  1335.               PACKLIST  DOC     C:\TOOLDRIV\
  1336.  
  1337.   *** END OF REPORT
  1338. ────────────────────────────────────────────────────────────────────────────
  1339.  
  1340. Extended Reports
  1341. The extended report style identifies files with their full file
  1342. specification. If your filenames alone are not unique, then this report
  1343. style may be more useful to you.
  1344.  
  1345.  
  1346. Figure 11: Extended File Cross Reference Report
  1347.  
  1348. ────────────────────────────────────────────────────────────────────────────
  1349.  09/19/92  05:37:40    EXTENDED FILE CROSS REFERENCE REPORT         Page   1
  1350.  
  1351.  
  1352.  FILE SPECIFICATION - REFERS TO: FILE SPECIFICATION   - REFERS TO:  FILENAME
  1353.  --------------------------      ---------------------------------  --------
  1354.                                - C:\TOOLDRIV\FILEXRF.DOC         -
  1355.  C:\TOOLDRIV\PACKLIST.DOC      - C:\TOOLDRIV\HISTORY.DOC         -
  1356.  C:\TOOLDRIV\TOOLDRIV.DOC      -                                 -
  1357.                                - C:\TOOLDRIV\NAMECHNG.DOC        -  README
  1358.                                - C:\TOOLDRIV\PACKLIST.DOC        -  HISTORY
  1359.                                -                                 -  README
  1360.                                -                                 -  REGISTER
  1361.                                -                                 -  TOOLDRIV
  1362.  C:\TOOLDRIV\NAMECHNG.DOC      - C:\TOOLDRIV\README.DOC          -
  1363.  C:\TOOLDRIV\PACKLIST.DOC      -                                 -
  1364.  C:\TOOLDRIV\TOOLDRIV.DOC      -                                 -
  1365.  C:\TOOLDRIV\PACKLIST.DOC      - C:\TOOLDRIV\REGISTER.DOC        -
  1366.  C:\TOOLDRIV\TOOLDRIV.DOC      -                                 -
  1367.  C:\TOOLDRIV\PACKLIST.DOC      - C:\TOOLDRIV\TOOLDRIV.DOC        -  HISTORY
  1368.                                -                                 -  README
  1369.                                -                                 -  REGISTER
  1370.  *** END OF REPORT
  1371. ────────────────────────────────────────────────────────────────────────────
  1372.  
  1373.                                                                     Page  33
  1374.  
  1375. Figure 12: Extended Word Usage Report
  1376.  
  1377. ────────────────────────────────────────────────────────────────────────────
  1378.  09/19/92 05:33:38 FileXref  EXTENDED WORD USAGE REPORT     Page 1
  1379.  
  1380.  WORD                   IS REFERENCED BY FILENAME(S):
  1381.  --------------------   ------------------------------------------
  1382.  However                C:\TOOLDRIV\FILEXRF.DOC
  1383.  Hungarian              C:\TOOLDRIV\NAMECHNG.DOC
  1384.  I                      C:\TOOLDRIV\FILEXRF.DOC
  1385.                         C:\TOOLDRIV\HISTORY.DOC
  1386.                         C:\TOOLDRIV\NAMECHNG.DOC
  1387.                         C:\TOOLDRIV\README.DOC
  1388.                         C:\TOOLDRIV\REGISTER.DOC
  1389.                         C:\TOOLDRIV\TOOLDRIV.DOC
  1390.  IBM                    C:\TOOLDRIV\NAMECHNG.DOC
  1391.  ---------------------  ------------------------------------------
  1392.  
  1393.  *** END OF REPORT
  1394. ────────────────────────────────────────────────────────────────────────────
  1395.  
  1396. Export files
  1397. The quote and comma delimited export files are provided so you can import
  1398. them into your software. You can then further process the data and/or
  1399. produce custom reports of your own design.
  1400.  
  1401. File FILEXREF.XRF is the name of the text file where the cross reference
  1402. export data is written.  It contains a symbol in the first column. The
  1403. second column contains the referencing file's file specification. The last
  1404. column has six flags. Their meaning is shown in the table following.
  1405.  
  1406. Table 7: Export file flags
  1407.  
  1408.  ────────────────────────────────────────────────────-
  1409.  123456
  1410.  ─────-
  1411.       The symbol in the first column is:
  1412.  1.....     a filename.
  1413.  .1....     a whole word.
  1414.  ..1...     a word prefix.
  1415.  ...1..     an expansion of a word prefix.
  1416.  ....1. The symbol was referenced.
  1417.  .....1 The symbol was marked for inclusion.
  1418.  ────────────────────────────────────────────────────-
  1419.  
  1420. Figure 13 shows typical data in the cross reference export data file.  The
  1421. first row shows that the symbol "HISTORY" was referenced by a file named
  1422. PACKLIST.DOC. The flags for this symbol tell that the symbol HISTORY is the
  1423. name of a file, that it was referenced (every entry in this file will be so
  1424. marked), and that it was marked for inclusion. (All file names are
  1425. automatically marked for inclusion by default. 
  1426.                                                                     Page  34
  1427.  
  1428. Figure 13: Cross reference export data
  1429.  
  1430.  ─────────────────────────────────────────────────────-
  1431.  "HISTORY","C:\TOOLDRIV\PACKLIST.DOC","100011"
  1432.  "HISTORY","C:\TOOLDRIV\TOOLDRIV.DOC","100011"
  1433.  "README","C:\TOOLDRIV\NAMECHNG.DOC","100011"
  1434.  "README","C:\TOOLDRIV\PACKLIST.DOC","100011"
  1435.  "README","C:\TOOLDRIV\TOOLDRIV.DOC","100011"
  1436.  "REGISTER","C:\TOOLDRIV\PACKLIST.DOC","100011"
  1437.  "REGISTER","C:\TOOLDRIV\TOOLDRIV.DOC","100011"
  1438.  "TOOLDRIV","C:\TOOLDRIV\PACKLIST.DOC","100011"
  1439.  "re*","C:\TOOLDRIV\FILEXRF.DOC","001101"
  1440.  "re*","C:\TOOLDRIV\HISTORY.DOC","001101"
  1441.  "re*","C:\TOOLDRIV\NAMECHNG.DOC","001101"
  1442.  "re*","C:\TOOLDRIV\README.DOC","001101"
  1443.  "re*","C:\TOOLDRIV\REGISTER.DOC","001101"
  1444.  "re*","C:\TOOLDRIV\TOOLDRIV.DOC","001101"
  1445.  "reach","C:\TOOLDRIV\TOOLDRIV.DOC","000101"
  1446.  "read","C:\TOOLDRIV\FILEXRF.DOC","000101"
  1447.  "read","C:\TOOLDRIV\NAMECHNG.DOC","000101"
  1448.  ─────────────────────────────────────────────────────-
  1449.  
  1450. Figure 14 shows the export data for unreferenced files. This data is stored
  1451. in text file FILEXREF.FEI (for file end items).  None of these files was
  1452. referenced by any other file examined.
  1453.  
  1454. Figure 14: Unreferenced files export data
  1455.  
  1456.  ───────────────────────────────────────────-
  1457.  "C:\TOOLDRIV\FILEXRF.DOC","100001"
  1458.  "C:\TOOLDRIV\NAMECHNG.DOC","100001"
  1459.  "C:\TOOLDRIV\PACKLIST.DOC","100001"
  1460.  ───────────────────────────────────────────-
  1461.  
  1462. View the output log
  1463. This command gives you a file viewer window to browse the messages about the
  1464. cross referencing. These document the scope of the run, listing the files
  1465. and words specified, the options, and record counts. You can use File│Print
  1466. to get a hardcopy of this output log to file with the reports.  The name of
  1467. the log file is FILEXREF.MSG.
  1468.  
  1469. NameChanger menu Alt+N
  1470. Use the NameChanger menu whenever you want to go back and make your naming
  1471. conventions consistent across your application(s). You might decide to do
  1472. this after each revision level is complete to keep order. And, now that you
  1473. have such a tool, you may want to go back to some older code you're still
  1474. maintaining and clean it up, too.
  1475.  
  1476. You will also want to use the NameChanger menu when you have a successful
  1477. product on one platform and want to port it to another. Download the non-DOS
  1478. product to your PC, do the renaming, and recompile on DOS. Or, do renaming,
  1479. upload to a non-DOS platform and recompile there.  This works very well for
  1480. Oracle code where the names may be the ONLY portability issue.
  1481.  
  1482. This command invokes a DOS program - NAMEC.EXE. For information on using
  1483. this directly from a DOS command line, see the separate NameChanger User's
  1484. Guide in the text file NAMECHNG.DOC.
  1485.                                                                     Page  35
  1486.  
  1487. Files to process
  1488. This is where you identify the files to be processed by NameChanger. The
  1489. dialog box you use looks like this:
  1490.  
  1491. Figure 15: NameChanger Files dialog
  1492.  
  1493.  ╔══[■}══  Files with names to be changed ════════╗
  1494.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1495.  ║░[X]  Generate a file list for me ░░░░░░░░░░░░░░║
  1496.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1497.  ║░     using the directory:  ░░░░░░░░░░░░░░░░░░░░║
  1498.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1499.  ║░»C:\PROJECT1                             ░░░░░║
  1500.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1501.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1502.  ║░░░░░░░░░░░░░░░░░░░»  OK  «░░  Cancel  ░░░░░░░░░║
  1503.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1504.  ╚════════════════════════════════════════════════╝
  1505.  
  1506. If you check the check box and enter a directory (as above) or drive (like
  1507. C:), then a list will be prepared for you. It will be written to file
  1508. NAMEC.FSL (File Specification List). The list will include only those files
  1509. in the directory entered.
  1510.  
  1511. In any case you will be presented with an edit window for this file. So the
  1512. content of the file edit window will be what was just generated if you
  1513. checked the check box, or it will be as most recently edited by you, or as
  1514. delivered on the installation disk.
  1515.  
  1516. Typical lines in this file (NAMEC.FSL) look like:
  1517. ──────────────────────────────────────
  1518. V    255   C:\PROJECT1\TST01.CPP
  1519. V    255   C:\PROJECT1\TST02.CPP
  1520. V    255   C:\PROJECT1\TST03.CPP
  1521. F     80   C:\PROJECT2\REPORT01.COB
  1522. F     80   C:\PROJECT2\REPORT02.COB
  1523. ──────────────────────────────────────
  1524. Each line defines one file and contains three columns.  The first column
  1525. defines whether all the lines in the file have to be the same length (F for
  1526. fixed length), or variable length (V).  The second column is the maximum
  1527. length for an output record (or actual in the case of fixed length file
  1528. lines). The last column contains the file specification.
  1529.  
  1530. The line format code ( F or V) must begin in the first column of the line.
  1531. One or more spaces separate the columns. Press Enter after each line.
  1532.  
  1533. Press F3 to save your changes or F4 to close the window (this will cause a
  1534. prompt to save).
  1535.  
  1536. NOTE: The editor will handle files up to about 64K. This will handle
  1537. hundreds of file names.  If your application is larger than this we trust
  1538. that you have an editor! Drop out of ToolDriver, edit the list with that
  1539. editor, and return to ToolDriver to change names.
  1540.                                                                     Page  36
  1541.  
  1542. Names to be changed
  1543. This is where you define the names you want to be changed. A file editor
  1544. window will be displayed so you can add one line for each name change. To
  1545. change "cat", "Cat", and "CAT" to "Dog", type
  1546.  
  1547. I    cat      Dog
  1548.  
  1549. That's all there is to it - The letter "I" tells the program to be
  1550. Insensitive to case.  Type one or more spaces after the case sensitivity
  1551. code, start typing the old word, type one or more spaces, type the new word
  1552. exactly as it is to appear, then press Enter.
  1553.  
  1554. To change "Alpha" to "Beta" , while leaving "ALPHA" (and "AlPhA") unchanged,
  1555. the entry should look like this:
  1556.  
  1557. S Alpha Beta
  1558.  
  1559. This change will be Sensitive to the case of the old name. It will not alter
  1560. the word Alpha unless the case of each letter matches exactly.
  1561.  
  1562. The case sensitivity code (I or S) must start in the first column of each
  1563. line.  When you've entered all the names to be changed, press F3 to save the
  1564. file, and then F4 to close the file editor window. It will be saved as
  1565. filename NAMEC.SRL (Symbol Rename List).
  1566.  
  1567. Start name changing
  1568. After you've defined the files and names to be changed, select the "Start
  1569. name changing" dialog.  It looks like this:
  1570.  
  1571. Figure 16: The Change names dialog
  1572.  
  1573.  ╔══[■}═══════════════ Change names ══════════════════════╗
  1574.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1575.  ║ NOTE: Output files will be written to this  ░░░░░░░░░░░║
  1576.  ║░      directory:                            ░░░░░░░░░░░║
  1577.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1578.  ║░ C:\TOOLDRIV\WORK ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1579.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1580.  ║░░░[ ] Delete prior output░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1581.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1582.  ║░░░░░░░░░░░░░░░░░░ »  OK  « ░░ Cancel ░░░░░░░░░░░░░░░░░░║
  1583.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1584.  ╚════════════════════════════════════════════════════════╝
  1585.  
  1586. Whenever you do name changing, the output files will be written to
  1587. ToolDriver's subdirectory named WORK. This is the WORK directory's only
  1588. purpose. Your files will never be rewritten in place! If you are rerunning a
  1589. name changing task, no work will be performed if any output file already
  1590.                                                                     Page  37
  1591.  
  1592. exists on the ToolDriver WORK subdirectory. To delete ALL files in the
  1593. ToolDriver WORK directory, check the checkbox. As a final precaution, you
  1594. will be asked to confirm the deletion, when the process starts. This is a
  1595. reminder for you to move prior output to a permanent home in another
  1596. directory before renaming other projects. When the changing of names is
  1597. complete, you will be presented with a file viewer window to browse a log of
  1598. the renaming activity. This name of this text file is NAMEC.MSG.  This log
  1599. will identify those files that were not changed at all (those that contained
  1600. none of the names being changed).  It also identifies, by line number, those
  1601. cases where lines needed to be split due to excessive length after renaming.
  1602.  
  1603. To test NameChanger, have it make an exact copy of some of your files. Do
  1604. this by setting the symbol rename list up with one line containing a word
  1605. that doesn't exist in your files, say
  1606.    S  aAbBcC   AABBCC
  1607. Start NameChanger, then use the DOS COMP command to do a character-by-
  1608. character compare.
  1609.  
  1610. NOTE: Trailing blanks in lines are not copied so it's possible for the
  1611. messages to indicate that no words were changed, and still have file
  1612. sizes be different.
  1613.  
  1614. View the output files
  1615. Select this option to inspect the results of your name changing. The
  1616. following dialog lets you select a file on the ToolDriver working directory
  1617. (where NameChanger places its output).
  1618.  
  1619.  
  1620. Figure 17: View the name-changed files dialog box
  1621.  
  1622.  ╔══[■}═════════════════ View a File ═══════════════════╗
  1623.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1624.  ║░░ Name░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1625.  ║░░░ *.*                              ░░░░░ Open  ░░║
  1626.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1627.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1628.  ║░░ Files                               ░░░░░░░░░░░░░░░║
  1629.  ║░░░ FILEXREF.RPT      │  TST01.C       ░░░░  Cancel ░░║
  1630.  ║░░░ FILEXREF.DOC      │  TST02.CPP     ░░░░░░░░░░░░░░░║
  1631.  ║░░░ HISTORY.DOC       │  TST03.H       ░░░░░░░░░░░░░░░║
  1632.  ║░░░ NAMECHNG.DOC      │  TST04.PAS     ░░░░░░░░░░░░░░░║
  1633.  ║░░░ PACKLIST.DOC      │  ..\           ░░░░░░░░░░░░░░░║
  1634.  ║░░░ REGISTER.DOC      │                ░░░░░░░░░░░░░░░║
  1635.  ║░░░ TOOLDRIV.DOC      │                ░░░░░░░░░░░░░░░║
  1636.  ║░░░ ■▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓     ░░░░░░░░░░░░░░░║
  1637.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1638.  ║░░░C:\TOOLDRIV\WORK\*.*                               ║
  1639.  ║░░░FILEXREF.RPT 88722           Sep 18,1992   08:25a  ║
  1640.  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║
  1641.  ╚══════════════════════════════════════════════════════╝
  1642.  
  1643.                                                                     Page  38
  1644.  
  1645. See the "View a file" dialog description on page 21 for a review of using
  1646. this dialog.
  1647.  
  1648. Window menu   Alt+W
  1649. The Window menu contains window-management commands. Most of the windows you
  1650. open from this menu have all the standard window elements like scroll bars,
  1651. a close box, and zoom boxes. Refer to page 15 for information on these
  1652. elements and how to use them.
  1653. Size/Move  Ctrl+F5
  1654. Choose Window│Size/Move to change the size or position of the active window.
  1655.  
  1656. When you choose this command, the active window moves in response to the
  1657. arrow keys. When the window is where you want, press Enter. You can also
  1658. move a window by dragging its title bar.
  1659.  
  1660. If you press shift while you use the arrow keys, you can change the size of
  1661. the window. When it's the size you want, press enter. If a window has a
  1662. resize corner, you can drag that corner or any other corner to resize it.
  1663.  
  1664.  
  1665. Zoom F5
  1666. Choose Window│Zoom to resize the active window to the maximum size. If the
  1667. window is already zoomed, you can choose this command again to restore it to
  1668. its previous size. You can also double-click anywhere on the top line
  1669. (except where an icon appears) of a window to zoom or unzoom it.
  1670.  
  1671. Tile
  1672. Choose Window│Tile to arrange all your open windows like tiles on the
  1673. screen.
  1674.  
  1675. Cascade
  1676. Choose Window│Cascade to stack all open windows so the top of each (with its
  1677. window number) shows.
  1678.  
  1679.  
  1680. Next F6
  1681. Choose Window│Next to make the next window active and visible.
  1682.  
  1683. Previous   Shift+F6
  1684. Choose Window│Previous to make the prior window active and visible.
  1685.  
  1686. Close   F4
  1687. To close the current window, press F4.
  1688.  
  1689.                                                                     Page  39
  1690.  
  1691. Help menu  Alt+H
  1692. The help menu gives you access to online help in a special window. There is
  1693. help information on virtually all aspects of the ToolDriver environment. To
  1694. open a Help window, do one of these actions:
  1695.  ■ Press F1 at any time (including from any dialog box or when any menu
  1696.    command is selected).
  1697.  
  1698.  ■ Click Help on the status line.
  1699.  
  1700. To close the Help window, press Esc, click the close box, or choose
  1701. Window│Close.
  1702.  
  1703. Help screens often contain keywords (highlighted text) that you can choose
  1704. to get more information. Press Tab to move to any keyword; press Enter to
  1705. get more detailed help. (As an alternative, move the cursor to the
  1706. highlighted keyword and press Enter.) With a mouse, you can double-click any
  1707. keyword to open the Help text for that item.
  1708.  
  1709. When you're in a detailed help screen (you got there from another help
  1710. screen by selecting a keyword) and you want to go back to the previous help,
  1711. press Alt+F1. By doing this repeatedly you can back-track to the original
  1712. help screen where you selected the first keyword.
  1713.  
  1714. Contents
  1715. The Help│Contents command opens the Help window with the main table of
  1716. contents displayed.  From this window, you can branch to other parts of
  1717. the help system.
  1718.  
  1719. Index
  1720. The Help│Index command displays a full list of Help keywords (the special
  1721. highlighted text in Help screens that let you quickly move to a related
  1722. screen). These are arranged in alphabetical order.
  1723.  
  1724. Double-click or Tab to the item you want and press Enter, or Tab to the
  1725. "next page" keyword and press Enter to see the next page of keywords. Hold
  1726. down Shift and press Tab to move the cursor to a prior entry on the same
  1727. page.
  1728.  
  1729. Use Alt+F1 to get back to the previous help screen.
  1730.  
  1731.                                                                     Page  40
  1732.  
  1733. INDEX
  1734.  ──────────────────────────────────────
  1735.  
  1736.  File
  1737.      export, file cross reference . . . . . . . . . . . . . . . . . . .  33
  1738.      export, selecting. . . . . . . . . . . . . . . . . . . . . . . . .  30
  1739.      export, unreferenced files . . . . . . . . . . . . . . . . . . . .  34
  1740.      list, for cross referencing. . . . . . . . . . . . . . . . . . . .  28
  1741.      list, for name changing. . . . . . . . . . . . . . . . . . . . . .  35
  1742.  FILEXREF.EXE
  1743.      the cross reference tool . . . . . . . . . . . . . . . . . . . . .  28
  1744.  FILEXREF.FEI
  1745.      the unreferenced files export file . . . . . . . . . . . . . . . .  34
  1746.  FILEXREF.FSL
  1747.      the file specification list for FileXref . . . . . . . . . . . . .  28
  1748.  FILEXREF.MSG
  1749.      the cross reference activity log . . . . . . . . . . . . . . . . .  34
  1750.  FILEXREF.RPT
  1751.      the cross reference report file. . . . . . . . . . . . . . . . . .  30
  1752.  FILEXREF.WSL
  1753.      file of words to be cross referenced . . . . . . . . . . . . . . .  29
  1754.  FILEXREF.XRF
  1755.      the cross reference export file. . . . . . . . . . . . . . . . . .  33
  1756.  Hot keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
  1757.  Log
  1758.      of cross referencing . . . . . . . . . . . . . . . . . . . . . . .  34
  1759.      of name changing activity. . . . . . . . . . . . . . . . . . . . .  37
  1760.  NAMEC.EXE
  1761.      the name-changing tool . . . . . . . . . . . . . . . . . . . . . .  34
  1762.  NAMEC.FSL
  1763.      file of file names to be name-changed. . . . . . . . . . . . . . .  35
  1764.  NAMEC.MSG
  1765.      file containing a log of the renaming process  . . . . . . . . . .  37
  1766.                                                                     Page  41
  1767.  
  1768.  NAMEC.SRL
  1769.      file of symbol renaming rules  . . . . . . . . . . . . . . . . . .  36
  1770.  report
  1771.      condensed file cross reference, sample. . . . . . . . . . . . . .   31
  1772.      condensed word usage, sample. . . . . . . . . . . . . . . . . . .   31
  1773.      creating . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  30
  1774.      extended file cross reference, sample. . . . . . . . . . . . . . .  32
  1775.      extended word usage, sample. . . . . . . . . . . . . . . . . . . .  33
  1776.      list of unreferenced files, sample . . . . . . . . . . . . . . . .  32
  1777.      printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  30
  1778.      selecting the type of. . . . . . . . . . . . . . . . . . . . . . .  30
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785. ───────────────────────────────────────
  1786.   End of User Guide for ToolDriver
  1787. ───────────────────────────────────────
  1788.  
  1789.  
  1790.  
  1791.